package com.ruoyi.system.service;

import java.util.List;
import org.springframework.web.multipart.MultipartFile;
import org.springframework.data.mongodb.gridfs.GridFsResource;
import com.ruoyi.system.domain.Files;
import java.io.IOException;

/**
 * 文件服务接口
 * 
 * @author ruoyi
 * @date 2025-07-07
 */
public interface IFilesService 
{
    /**
     * 查询文件
     *
     * @param id 文件主键
     * @return 文件
     */
    public Files selectFilesById(Long id);

    /**
     * 查询文件列表
     *
     * @param files 文件
     * @return 文件集合
     */
    public List<Files> selectFilesList(Files files);

    /**
     * 新增文件
     *
     * @param files 文件信息
     * @param file 文件内容
     * @return 结果
     */
    public int insertFiles(Files files, MultipartFile file) throws IOException;

    /**
     * 修改文件
     *
     * @param files 文件
     * @return 结果
     */
    public int updateFiles(Files files);

    /**
     * 批量删除文件
     *
     * @param ids 需要删除的文件主键集合
     * @return 结果
     */
    public int deleteFilesByIds(String ids);

    /**
     * 删除文件信息
     *
     * @param id 文件主键
     * @return 结果
     */
    public int deleteFilesById(Long id);

    /**
     * 下载文件
     *
     * @param id 文件ID
     * @return GridFsResource
     */
    public GridFsResource downloadFile(Long id);

    /**
     * 批量新增文件
     *
     * @param files 待上传的文件数组
     * @return 成功上传的文件数量
     * @throws IOException 如果上传过程中出现IO异常
     */
    public int insertFilesBatch(MultipartFile[] files) throws IOException;
}
